PATHMac OS 8 Developer Documentation > Networking and Communications > AppleShare >

User Authentication Modules

UAMInitialize Routine

Initialize a server UAM.



 
Boolean UAMInitialize (void);

result: If the UAMInitialize routine completes successfully, it should return TRUE ; otherwise, it should return FALSE .

DISCUSSION

Server UAMs may export a UAMInitialize routine that performs initialization operations, such as allocating memory.

A server UAM's UAMInitialize routine is called once during the startup process at deferred task time, so it cannot call the Memory Manager to allocate memory, but it can use other memory allocation mechanisms, such as the Open Transport memory allocation functions, which use the Apple Shared Library Manager.

Server UAM initialization routines are called after the AppleShare Registry is initialized but before the AppleShare Registry is made available for general use. Unlike the _Initialize routine, the UAMIntialize routine can call AppleShare Registry functions.

If a UAMInitialize routine encounters an error, it should return FALSE . When a server UAM's UAMInitialize routine returns FALSE , it is unloaded immediately.

Note

Your server UAM can have both a UAMInitialize routine and an _Initialize routine.